package com.ztorn.fiscale.service;

import java.util.List;
import com.ztorn.fiscale.domain.FiscaleCustomsDeclaration;

/**
 * 报关单管理Service接口
 * 
 * @author ztorn
 * @date 2025-01-19
 */
public interface IFiscaleCustomsDeclarationService 
{
    /**
     * 查询报关单管理
     * 
     * @param declarationId 报关单管理主键
     * @return 报关单管理
     */
    public FiscaleCustomsDeclaration selectFiscaleCustomsDeclarationByDeclarationId(Long declarationId);

    /**
     * 查询报关单管理列表
     * 
     * @param fiscaleCustomsDeclaration 报关单管理
     * @return 报关单管理集合
     */
    public List<FiscaleCustomsDeclaration> selectFiscaleCustomsDeclarationList(FiscaleCustomsDeclaration fiscaleCustomsDeclaration);

    /**
     * 新增报关单管理
     * 
     * @param fiscaleCustomsDeclaration 报关单管理
     * @return 结果
     */
    public int insertFiscaleCustomsDeclaration(FiscaleCustomsDeclaration fiscaleCustomsDeclaration);

    /**
     * 修改报关单管理
     * 
     * @param fiscaleCustomsDeclaration 报关单管理
     * @return 结果
     */
    public int updateFiscaleCustomsDeclaration(FiscaleCustomsDeclaration fiscaleCustomsDeclaration);

    /**
     * 批量删除报关单管理
     * 
     * @param declarationIds 需要删除的报关单管理主键集合
     * @return 结果
     */
    public int deleteFiscaleCustomsDeclarationByDeclarationIds(Long[] declarationIds);

    /**
     * 删除报关单管理信息
     * 
     * @param declarationId 报关单管理主键
     * @return 结果
     */
    public int deleteFiscaleCustomsDeclarationByDeclarationId(Long declarationId);

    /**
     * 根据报关单号查询报关单
     * 
     * @param declarationNo 报关单号
     * @return 报关单信息
     */
    public FiscaleCustomsDeclaration selectFiscaleCustomsDeclarationByDeclarationNo(String declarationNo);

    /**
     * 生成报关单号
     * 
     * @return 报关单号
     */
    public String generateDeclarationNo();

    /**
     * 从订单创建报关单
     * 
     * @param fiscaleCustomsDeclaration 报关单信息
     * @param orderIds 订单ID数组
     * @return 结果
     */
    public int createDeclarationFromOrders(FiscaleCustomsDeclaration fiscaleCustomsDeclaration, Long[] orderIds);

    /**
     * 提交报关单
     * 
     * @param declarationId 报关单ID
     * @return 结果
     */
    public int submitCustomsDeclaration(Long declarationId);

    /**
     * 审批报关单
     * 
     * @param declarationId 报关单ID
     * @param customsStatus 报关状态
     * @param customsOfficer 报关员
     * @return 结果
     */
    public int approveCustomsDeclaration(Long declarationId, String customsStatus, String customsOfficer);

    /**
     * 批量更新报关单状态
     * 
     * @param declarationIds 报关单ID数组
     * @param customsStatus 报关状态
     * @return 结果
     */
    public int batchUpdateCustomsStatus(Long[] declarationIds, String customsStatus);
}